
THE 

DISK DRIVE 


HANDBOOK FOR THE BBC MICRO 

(Including DFS commands) 









INTRODUCTION 


The floppy disk drive was first commercially developed by IBM in 
an 8" Single Sided Single Density (128 bytes/sector) foot plate and 
was used mainlyfordiagnosis in their mainframe computers. Attheturn 
of the eighties when micro computers first became available, the 5!4 
inch floppy disk drive was developed by Shugart, a model of which is 
preserved in the Smithsonian Institute in Washington, D.C. forall time. 
Drives have come a long way since then, first from cam stepping 
mechanisms to high speed band stepping mechanisms, and finally to 
perfection of the double sided head byTandon in 1981 with the use 
of Ultra Large Scale Integration in chip design and the development of 
ULA's to replace several TTL functions. The cost of sub system units 
has been driven down from a 400K unit in 82 at£1,000 to a mere £390 
in 1983. Prices will not drop much more significantly now but the 
performance will increase dramatically with the use of Run length 
limited encoding, vertical recording and the use of higher grade 
media. 

The disk unit interfaces to the BBC by the Industry Standard 
Shugart interface, to a disk controller which is located on the main 
board of the computer. The disk controller chip is controlled by the 
CPU and looks afterthe data transfer, head positioning and motor start 
up. The disk controller chip decides on the code it reads and writes to 
the disks surface in. The Acorn interface writes in FM which requires a 
synch pulse (Bit) between every data Bit, it therefore follows that every 
other Bit cannot be used by the user and the capacity of the disk is 
reduced by 50%. Microware offer an MFM controller which uses a 
Phase Locked Loop process to encode data which does not require the 
synch pulse, therefore release the unused synch bits for data storage, 
this process was developed by Professor Millar from the M.l.T. and is 
used throughout the computer industry today. 

This book is intended to enable the BBC micro user to better 
understand the drive units he intends to use. The first part shows the 
upgrade process, the second part covers the DDFS commands. The 
final section covers transfer of tape to disk and the use of machine 
code and disk handling, if the drives are used with Acorns standard DFS 
then a format disk will be required in order to load the format program 
illustrated under ★ FORMAT. (See Appendix B). 
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SPINDLE 


The purpose of this booklet is to errable you to add the powerful 
disc operating system to your BBC machine. This will enable programs 
to be loaded and saved much faster than cassette operation. Included 
with this is a set of IC's and a DFS ROM which contains programs for 
setting up and checking the discs prior to storing data and programs. 

The booklet will describe the modifications in step-by-step detail 
and then give a description of the various disc commands and their 
uses. 


The modifications to your machine consist of adding IC's and 
changing links and may also require soldering work in some cases*. We 
would recommend that only competant persons who are used to 
working with electronic equipment carry this out although the actual 
work involved is fairly straightforward. 

To carry out these modifications a Model 'B' machine fitted with 
the 1.2 Operating System must be used. Model 'A' machines may be 
used but these must be up-graded to the 'B' version first. 


"THE UPGRADE" 

(Refer to main board layout drawing) 


Check that included with this kit are the following IC's:- 

1 x DIP SWITCH 

8 WAY 

2 x MC4013B 

(IC83,84) 

2 x 7438 

(IC79,80) 

1 x 74LS 393 

(IC86) 

1 x MC4020B 

(IC85) 

1 x HEADER 

(IC87) 

1 x (IDDFS 8272 

BOARD) (IC78) 

1 x 27128 (Disc Operating System EPROM) 


N.B. Leave the IC's in their protective packing until you are ready to fit 
them. 

*Depends on board revision. 
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2. Switch OFF and disconnect the computerfrom the mains supply. 

3. Remove the top cover by removing two screws marked "FIX" at 
the rear of the machine and two screws marked "FIX" fitted 
underneath the machine below the keyboard. 

4. Remove the keyboard held by two bolts at either end and 
disconnect the ribbon cable and flying lead from the loud¬ 
speaker. 

5. Wiring Changes for DDFS prior issue 4. IMPORTANT: This 
section consists of a wiring modification and needs to be carried 
out on Issues 1-3 printed circuit boards (the issue number is 
clearly printed on the main board). Issue 4 boards onwards DO 
NOT need the following modifications. 

i) Carefully cut the leg (pin 9) of IC27 and lift it clear of the 
solder pad. 

ii) Cut the track between pin 9 pad and 'S9' link by making a 
single cut in the track with a small modelling knife. 

iii) Soldera thin piece of insulated wire between pin 9 of the 1C 
leg and 'S9' (right hand pad). 

iv) On issue 1 or2 boards ONLY, add a wire link in position S8. 

6. Set the following link positions using shorting links:- 

S18 — North 
SI 9 — East 

520 — North 

521 — East/West (2 links) 

522 — North 

532 — West 

533 — West 
SI 2 — Cut link 
SI 3 — Cut link 

On issue 4 boards onwards, remove link S9. 

*lssue 3 and previous may have wider sockets requiring careful 
positioning of the chips in order to ensure good electrical contact. 
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7. 


Fit IC's 78, 79, 80, 86, 83, 84, 85, 87 into the sockets provided 
making sure that the orientation of each 1C is checked against the 
layout drawing (pin 1 of the IC's are normally marked by a small 
pip in the plastic housing by the leg). 

Check that none of the 1C pins become bent over when being 
inserted. An 1C insertion tool would be of help here. If one is not 
available, carefully bending the 1C pins so that the two rows of 
pins are parallel would assist in inserting them by hand. 

When they are all fitted, re-check the orientation again.Insert 
keyboard dip switch if required. This may require soldering. 

8. Fit the Disk Operating EPROM in the 4th position from the left in 
the block of five 28 pin sockets (IC51,52, 88, 100, 101). 

9. Re-fitthe keyboard, notforgetting to re-connectthe loudspeaker 
flying lead and ribbon cable, using the two nuts and bolts. 

10. Set up dip switches as per table at back of book. For 40 track 
drives links 1 and 2 should be off. For80 tracks switch 1 and 2 on. 

11. Re-fit cover using the four screws. 

1 2. Switch-on and listen for the double bleep. If all is well the screen 
should display:- 


BBC Computer 32IC 
MICROWARE DDFS 
BASIC 

> 


You are now ready to try out the disk drive. 
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Check that the diskettes you are using have the correct number of 
tracks (marked on the disk packet) to match up with your drive. Two 
types are available, 40 and 80 track and must be used with the correct 
drive. Sqme drives however, typically the 80 track drives are sometimes 
fitted with a Switch Option which allows 80 and 40 track disks to be 
used. 


Insert the disk with the label uppermost for drives mounted with 
the slot horizontally or with the label to the RIGHT for drives mounted 
with the slot vertically. There is also a small notch cut in the side of the 
disk to prevent any accidental overwriting of information (similar to the 
way in which cassettes can be prevented from being recorded over). 
This notch should be towards the left hand side of the slot for single 
drives, or towards the top of the slot for vertically mounted drives. For 
dual drive units the disk should be inserted into the LEFT hand drive. 
The disk MUST be inserted the right way round otherwise the 
computer will be unable to access information on it. Then close the 
door flap. Incorrect insertion, however, should not damage the 
diskette or the drive. 


The computer allocates drive numbers, as mentioned earlier, in 
the following way:- 


Single drive, single sided 
Single drive, double sided 
Dual drive, single sided 

Dual drive, double sided 


DRIVE 0 
DRIVE 0 & 2 
DRIVE 0 
DRIVE 1 
DRIVE 0 & 2 
DRIVE 1 & 3 


(l.h. drive) 
(r.h. drive) 
(l.h. drive) 
(r.h. drive) 


Each particular drive can be accessed by specifying its drive 
number, and this will be discussed later on. If no drive number has 
been specified, then DRIVE 0 is assumed to have been selected and 
the programs on the Drive 0 are selected. 
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BASIC CONCEPTS 


MINIMUM REQUIREMENTS 

Before you start using the Disk File system, check that you have the 
following items: 

A A disk drive with ribbon cable and power cable 
B A model 'B' microcomputer with the disk interface 
C A dual disk consists of two disk drives connected by a 
ribbon cable and a powercable, or powered by own P.S.U. 

The disk drive 

Computers have internal memory called Random Access Memory 
or ram. When you type in your program it is stored in ram. However, 
when you switch off the computer, everything stored in ram is lost. To 
overcome this problem the computer must be able to transfer the 
contents of ram into some form of permanent or 'non-volatile' storage 
before you switch off. The User Guide which comes with your BBC 
computer describes how to use a cassette recorder for this purpose. 
Transferring a program from ram to tape is called saving it, 
transferring from tape back to ram is called loading it. The 
disadvantages of using tape are: 

(a) The process of saving and loading is slow. 

(b) You need to keep track of where on the tape each piece of 
information is, so that you do not record over it. 

(c) You have to wind the tape to the right place yourself. 

(d) It is not possible to wind the tape to a particular point accurately. 

When you insert the disk into the disk drive and close the drive 
door a rotating boss engages with the central hole in the disk and 
spins the magnetic disk inside its protective jacket. In order to read or 
write information on to the disk the disk drive has a 'Read-Write Head'. 
This head is designed to move along the 'Head Slot' in the disk jacket. 
This head rests on the surface of the magnetic disk as it rotates inside 
the jacket. When you want to read some of the information on the disk, 
you access it by specifying the file name. When writing the name of 
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your program, referred to as a 'filename',it is written into the catalogue 
together with the number of the sector on the disk where the 
information starts. (Note it may continue over several sectors.) When 
you want the file containing your program back again you simply type 
LOAD "filename". The filing system checks the catalogue to find out 
where on the disk to find thatfile, and then moves the read/write head 
to that exact place on the disk. The file is then loaded into the 
computer's memory (ram) automatically. This illustrates another 
advantage of a disk drive. The read/write head can be quickly moved to 
any point on the disk with great accuracy. 

Because of this accuracy, a number of other facilities are 
available besides loading and saving programs. These include 
the ability to Copy, Delete, Build and Rename files. Additional facilities 
let you examine a disk catalogue, restrict access to files or move 
directly to specific points within a file. 

The filing system controls the disk drive but in turn we must be 
able to give instructions to the filing system. Two ways are provided. 
One is by typing a special command word preceded by the These 
are all listed together with details of theirfunctions. Any of these direct 
commands can be incorporated in a program if required. 

Additionally, the drives can be controlled directly by basic 
programming structures. 

When you SAVE one of your BASIC programs the disk filing 
system does the following: 

A — Starts the disk drive working. 

B — Finds a free place on the disk big enough for your 
program (64 sectors). 

C — Makes a note of where it put your program so as to be 
able to find it again. 

D — Moves the disk drive's read/write head to the start of 
the first sector in the free space. 

E — Transfers a copy of your program from the ram to the 
disk. 

F — Stops the disk drive. 
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When you save a program you have to give it a name. This is true 
for the disk system as well as the cassette system. However, the disk 
filing system puts the name to special use. A minimum of the first two 
sectors on every disk are reserved for a 'catalogue' when the disk is 
formatted. 

The BBC Microcomputer uses 5.25" or 3" disks for storing 
information. We refer to them as 'disks' or 'floppy disks'. 

Handling Diskettes 

Disks should be handled with care to avoid physical damage or 
damage to the recorded information. 

1 Do not try to remove the circular magnetic disk from the 
square, black protective jacket covering it. 

2 Do not touch the exposed recording surfaces. 

3 Avoid dust. Put the disks back into their envelopes when 
they are not in the disk drive. 

4 Do not bend them, drop them on the floor or put heavy 
objects on them. 

5 Keep them in a storage box designed for the purpose. 

6 Keep them away from strong magnetic fields such as those 
generated by televisions, monitors, tape recorders, 
transformers, etc. 

7 Avoid excessive heat, moisture and direct sunlight. 

8 Only use felt-tipped pens to write on the labels and don't 
press hard. 

9 Insert disks into the drive carefully. If it rotates noisily open 
the drive door and adjust it. 

Information is packed quite densely onto the disk, so it is 
sensitive to even very small scratches and particles of food, dust or 
tobacco smoke. 

The foregoing is comprehensive. Handled sensibly, a disk will 
give good service for anything from a few months to a couple of years, 
depending on type and manufacture. 
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Connecting the disk drive unit. 


















Write Protection 

There is a small notch in the side of a disk called the 
'write-protection' notch. It is used to protect the information on a disk 
from being overwritten, similar to the plastic tab on a cassette tape. 
Every box of disks is supplied with a number of adhesive tabs which 
can be used to cover the write-protection notch on the disk. The 
diagram below shows that covering the notch with one of the adhesive 
tabs will prevent the disk drive from writing ordeleting anything on the 
disk. Reading the existing information on the disk is still possible. 


Write protection sticker 




Another way of protecting information is to keep several copies 
of it on different disks. Where computers are used in businesses that 
use large volumes of information, a standard routine should be 
evolved. For personal computing it is not so vital, but you will want to 
keep several copies of important programs and information. The filing 
system provides two facilities which make copying easy. These are ★ 
BACKUP and ★ CO P Y which allowyou to copy data from one disk 
to another, ★BACKUP provides a mirror image and ★COPY a 
sequential copy. ★COPY switches density and tracking 
automatically. 
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Information is written 
tracks. Each track is dividi 
density mode used. Each 
Space on the disk and in the 
One byte corresponds to on 
are available for storing yoi 
that a 40 track single-sided. 






Formatting 

The disk filing system automatically records the location of your 
programs and data on the disk. Sectors on track zero of a disk are 
reserved for this purpose. The 'catalogue' of a disk is recorded in these 
sectors. Whenever you wish to access a piece of information on the 
disk, the filing system reads the catalogue first to find out where on the 
disk it can be found. The tracks and sectors are the reference marks on 
disk which make this possible. 

Clearly before a disk can be used by the filing system for storing 
your information it must have these 'reference marks' put onto it. The 
process is called 'formatting'. 

The system may be likened to a map requiring grid reference 
lines to be put on it in order to enable one to locate a position, or piece 
of information. 

The important thing to remember is that new disks must be formatted 
before you can use them with your computer. 


Before Formatting Track and Sector Layout After Formatting 



Single density 10 sectors per track. 

Double density 1 6 sectors per track. 1 SECTOR 
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Files 


Programs are saved by using the SAVE command in BASIC 
the filing system takes care of the rest. (NB Not to be confused with 

★ SAVE described later in this manual). When you have typed the 
program into the computer the SAVE command causes it to be 
copied on to the disk. When S A V E ' d, the program must be given a 
name. This is called the filename and is used to referto the program if 
you later want to use it or copy it back from the disk. Each program 
S A V E ' d on to the same drive must be given a unique name. The 
format of the SAVE command is 

SAVE 'filename' 

where 'filename' can be up to 7 characters. Letters and digits are 
allowed. The characters 

# ★ . : 

have special meanings which are explained further on. 

File Specification 

The full specification for a file is 

: Drive number. Directory. Filename. 

: <drv>. <dir>. <filename> 
e.g.: 

: 1. Z. STORE 

The drive number, directory and filename are separated by 
full-stops. These are needed so that the O.S. can distinguish the 
separate parts of the file specification. 

Drive Numbers 

Drive numbers must be in the range 0 to 3 and preceded by a : 
(colon). The colon tells the computer: 'This is the start of a file 
specification, the drive number following indicates which side is in 
use.' 


The drives are numbered as shown below. Notice that each side 
of a double-sided disk is given a separate drive number. 
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Single-drive, single sided 




Drive 0 


Dual-drive, double 


(Diskettes in situ.) 


sided 

Drive 0 



The effect of including the drive number in the full specification is 
that: 1 .$. STORE is different from : 2.$.STORE although the filenames 
are the same, they are on different drives. 


Directories 

The directory is a single character used to divide the catalogue 
into independent sections. Files of the same name can be created on 
the same disk with different directories. Although on the same drive, 
: 1 .$.STORE is a different file to : 1 .A.STORE because they are in 
different directories. 


Filenames 

The filename can be up to 7 of the characters on the keyboard in 
any combination, except the four invalid characters. Reference to the 
file specification will use the abbreviation <fsp>. 

When the filing system is started by pressing BREAK or 
SHI II FT/BREAK, the current directory and drive number is always 
set to drive 0 and directory $. The drive and directory can therefore be 
omitted from file specifications. They will be assumed to have the 
values shown above. CONTROL / BRE A Kcaused a cold reset re¬ 
reading the dip switches. 

Typing 

SAVE "STORE" 

will automatically store your program in a file named 
: 0.$.STORE 

assuming the current drive and directory remain unchanged. 
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Multi-file Operators ★ and # 

Another common term used to refer to multi-file operations are 
the 'Wildcard' operators. Some of the filing system commands can 
operate on a number of files instead of just one. These are all followed by the 
abbreviation <afsp> instead of <fsp>, <afsp> stands for 'ambiguous file 
specification'. ★ ! N F O is an example of such a command. It provides 
information about a named file, e.g.: 

★ INFO: 0.$.STORE 

will display information about the file named STORE in directory $ on 
drive 0. 

However, it is possible that you want information about a number 
of files. The 'wildcard' facilities enable you to specify several files for 
the command to operate on. The wildcards are provided by the 
characters ★ and # which have special meanings when they appear in 
the file specification, e.g.: 

★ i N ¥ © : 0.#.STORE 

means; 'Display information about files called STORE in any directory 
on drive O'. 

★ 0 N F © : O.S.STOR # 

means; 'Display information aboutall files on drive 0 in directory $ with 
names starting "STOR" followed by any single character', e.g. 

STORA, STORT and STORE etc. 

The character ★ means multiple #'s to the end of the field, e.g.: 

☆ IMF© : O.S.M k 

will display information about any files on drive 0 and directory $ 
whose names begin with M. 

Auto-start facilities 

Sometimes it is useful to make a program or a file on one of your 
discs ★LOAD, ★RUN or ★EXEC automatically when you insert 
the disc and press B R E A BC. This can be done using a file named 
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! I O O T, ! BOOT is a special filename recognised by the filing 
system when you start the computer by pressing S H 1 F T/B REAK. 
If there is a file of specification 

: 0.$.! BOOT 

the filing system will do one of four things according to the option set 
on the disc using * O PT 4,n 

Option 0 : ignores ! B O O T 

Option 1: ★LOAD'S ! BOOT into memory 
Option 2: ★RUM's SBOOTasa machine code program 
Option 3: ★EXEC's IBOOT 

The Options can be changed using the ★ O P T 4 command. 

As well as programs, you may wish to store data on the disks. The 
filing system provides special facilities for storing and retrieving the 
data quickly and selectively under the control of your programs. 

There are several good books on file handling in basic available. 

Library directory 

The disc file system enables you to specify one drive/directory as 
the 'Library'. This will always be set to :0.$ when you start the 
computer by pressing BREAK. It can be altered using the filing 
system command ★LIB, until the next BREAK. All the utility 
programs should be located in the library. This is because when you 
type 


★ (Utility name) 

it is equivalent to typing 

★ RUM (Utility name) 

where the drive and directory are omitted and will be assumed to be 
either the current drive/directory or the Library. The filing system will 
first search the current drive/directory for the file and then, if it cannot 
find it there, it searches the Library. 
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Filing system commands 

The Double Density Filing System is a 1 6k byte program. BASIC 
programs are stored on a diskortape, but the filing system is stored in 
Read Only Memory (rom) inside the BBC computer. The filing system 
controls the reading and writing of information to and from the disks 
and provides a number of useful facilities for maintaining such 
information. The filing commands are words which the filing system 
program will recognise and act on. They can be typed directly on to the 
keyboard or embedded within your BASIC program. They are all 
prefixed with the ★ character which signals the computer that a filing 
system command follows. Each command is described under a 
number of sections with headings as follows: 

Instruction 

This is followed by a syntax abbreviation and an explanation of 
the derivation of the word. 

<drv> = drive 

<fsp> = file specification 

<dir> = directory 

<afsp> = ambiguous file specification 

Example 

This section gives a few examples of the use of the commands. 
These examples are only intended to be illustrative. 

Description 

A description of the command. 

Associated commands 

This section lists commands which have similarfunctions or are 
normally used in conjunction with this command. 

Error Messages 

Indicates relevant messages. Controller messages are listed at the 
back of this manual. 
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★ ACCESS <afsp>(L) 

Prevents a file from being deleted or overwritten. The command 
'locks' or'unlocks' a file. You cannot operate on a locked file until you 
unlock it again. If you load a file which is locked, you will not be able to 
save it again with the same name, because saving a file with the same 
name as one already on the disk causes the one on the disk to be 
deleted and replaced with the new file. A locked file cannot be 
deleted. 

Example 

★ ACCESS STORE L 
This locks the file STORE 

★ ACCESS STORE 

unlocks it again so that it can be deleted or overwritten. 
Explanation 

Sets or disable file protection on a named file. It prevents a 
number of other filing system commands from acting on the file. 

Remarks 

Once locked a file will not be affected by the following 
commands: 

★ SAVE 
★DELETE 

★ WIPE 
★RENAME 
★DESTROY 

Error Messages 

FILE LOCKED 

Produced when you try to use a write operator on the locked file. 
DISC WRITE PROTECTED 

Produced when you try to ★ A C C E S S a write protected disk. 
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^ BACKU P (source drv) (dest. drv) 

Reads all the information on one disk and creates a mirror image 
on another, producing two disks with identical information and 
identical format. 

Example 

★ENABLE 
★BACKUP 0 1 

copies all the information on drive 0 onto drive 1. 

Description 

Sector by sector copy program. 

Associated commands 

★ COPY (USED TO SWITCH DENSITY) 

Remarks 

★ ENABLE must be typed before the command will work, 
otherwise the message 

Not Enabled 

is displayed. 

If you give 0 as the source and destination drives, e.g.: 

★ENABLE 
★BACKUP 0 0 

the program will alternately ask you to insert the source and 
destination disks into drive 0. This makes it possible to copy disks 
even if you only have a single drive. A 40 track disk is copied in 7 
sections. 

All information previously on the destination disk is overwritten, 
do not confuse the source and destination disks. If the source disk is 
blank the destination disk will end up blank as well. 

Note: Backup does not affect density or tracks. 
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Warning 

The contents of memory may be overwritten by this command. Save 
memory contents before using. 

Important 

Locking a file does not prevent it from being removed from a disk with 

★ FORMAT Oor from being overwritten with ★ B A C K U P. 

Messages 

DISC WRITE PROTECTED 

Produced if disk you are copying to is write protected. 

*See Controller Errors 

★ BUILD <fs P > 

Creates a file directly from the keyboard. After typing this 
command everything else entered will go into the named file. 

Example 

★ B U D l O HOOT 

will cause everything subsequently typed in to be entered into a file 
called HOOT. 

Line numbers are displayed on the screen to prompt you to enter 
your text as follows: 

> ★ B U I L D IBOOT 

00010 FIRST LINE OF TEXT = CH. "MENU" 

00020 SECOND LINE OF TEXT = ESC 

Typing E S C on a line by itself terminates a ★ B U I L D 
command. 

Description 

Builds a file from the keyboard. 

Associated commands 

★ EXEC 

★ LIST 

★ TYPE 
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★ CAT <drv> catalogue (★■) 

The command displays the catalogue of a disk on the screen, 
showing all the files present on the disk, (drv) is the number of the 
drive you want displayed. If (drv) is omitted the current drive is 
assumed. 

Example 

★ CAT 0 

TITLE (nn) DOUBLE DENSITY 

Dri ve:0 Option:2 (RUN) 

D i r e c t o r y : 0.$ L i b r a r y : 0.$ 

IBO0T GRAPH 

SNOOKER TABLE 

TEST DEFENDER 

A. GRAPH L B. SNOOKER 

Note the heading part of the catalogue shows the drive number, 
the title of the disk, entered from the FOR M A T program, the 
density mode in use and the currently set auto-start option of the disk 
(in this case 2 for R U N), and the currently selected library and 
directory. In the example above there are 8 files on the disk.! BOOT 
toDEFENDR are in the current directory $. The current directory's 
files are always listed first. AGRAPH is in directory A. It is also 
followed by L, meaning, that it is a 'locked' file. B. SNOOKER is in 
directory B and is not locked. (SVl) = number of write operations to the 
disk. 

Description 

Displays a disk catalogue. 

Associated commands 

★ INFO 
★ACCESS 
★TITLE 

★ OPT 4, n 

★ DIR 

★ DRIVE 
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Remarks 

Permitted values of <drv> are 0, 1, 2 or 3 default is 0. 
Important 

The Catalogue and hence the disk will hold up to a maximum of 31 
files, in single density. The final version of DDFS will hold up to 128 
filenames per side. 

Messages 

BAD DRIVE 

Drive number is not 0, 1, 2 or 3. 

★ COMPACT <drv> 

Attempting to SAVE a program orfile on to a disk may produce 
the message 'DISK FULL' if there is no single space available on the 
disk big enough for the information (64 sector block). It may be that 
there is enough space, but it is split into several small sections. 

★ COMPACT appends all spare space on a disk to the end. When 
you delete a number of files, the spaces they had occupied will usually 
be distributed over the disk with existing files between them. 

★ COM PACT moves all currentfiles to the 'start' of the disk leaving 
the spare space in one continuous block at the end. 

Example 

★COMPACT 

$.STORE 1700 801F 0003B 002 

S.PROG1 1700 801F 00098 003 


: DISK COMPACTED (XXX) FREE SECTORS 

As 'compacting' proceeds all the currentfiles are displayed in the 
order in which they occur on the disk. 

XXX is in HEX. 

Description 

Moves all available space on a disk into one continuous block 
following the current files. 


24 




Associated commands 


★ SAVE and BASIC's SAVE and OPERJIRJ 
Remarks 

This facility will only do anything if there is space between files. 
There will only be such space if a file has been deleted from between 
two others. 

Version 1.1 of DDFS will auto compact as a background task, 
using the DDFS RAM, giving a similar appearance to Random Sector 
Allocation. 

Warning 

This command may overwrite the contents of memory. If you have a 
program or data in memory that you want to keep, save it before you 
use this command. If your drive is double sided then do the following: 

> SAVE "STORE" 

> CANT EXTEND 

> ★DR. 2 

> SAVE "STORE" 

> ★ DR. 1 

> ★ COMPACT 

Messages 

DISK WRITE PROTECTED 

occurs when diskette is write protected. 
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COPY <source drv> <dest. drw> 


<afsp> 


Used to copy a named file or files from one disk to another. 
Example 

★ COPY 0 1 STORE 

This copies a file called STORE in the current directory on drive 0 
onto drive 1. 

Description 

File by file copy program. 

Associated commands 

★ENABLE 

★BACKUP 

Remarks 

The 'wildcard' facilities may be used to specify a group of files to 
be copied e.g.: 

★ COPY 0 1 ★.★ 

Copies all files irrespective of which directory they are in. 
Information already on the destination disk is not affected. Use 
★ OPT 4, 3 in order to transfer autoboot facility, once copy is 
completed. ★COPY switches density and tracking automatically. 

Warning 

This command may overwrite the contents of memory. If you have a 
program or data in memory, save it before using this command. 

See Controller error messages. 
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★ DELETE <fsp> 


Removes a single file from the catalogue of a disk. The space 
occupied by the file becomes available for other information. Succeeding 
file names in the catalogue are shuffled up. 

Example 

★ DELETE STORE 

removes a file called STORE from the current directory on the current 
disk. 

Description 

Single file deletion. 

Associated commands 

★ WIPE 
★DESTROY 
★COMPACT 

Remarks 

Does not allow use of multi file operators. 

Messages 

DISK WRITE PROTECTED 
Occurs if diskette is write protected. 

FILE NOT FOUND 

Occurs if specified file is not in catalogue. 

FILE LOCKED 

Occurs if file is locked (see ★ACCESS) 
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★ DESTROY <afsp> 

Removes specified files from the disk in a single action. This 
command takes the ambiguous file specification so that groups of files 
can be deleted. When you use this command a list of the files to be 
deleted is displayed. A single Yes/No question appears at the end of 
the list offering you the choice to delete all the listed files as required. 
Its effect is not reversible. It will not attempt to remove locked files. 

Example 

★ENABLE 

★ DESTROY ★ ,S ★ 

A. STORE 
$. STORE 

Delete (Y/N)? 

If you type Y in reply to the question all the named files will be 
deleted. The message 

D e 0 @ t @ d 

is displayed when deletion is complete. Typing anything else cancels 
the command. 

Associated commands 

★ENABLE 

★ WIPE 
★DELETE 

Remarks 

Once destroyed files cannot be restored. 

★ ENABLE must be typed immediately before ★DESTROY 
or it will not work. 

Messages 

NOT ENABLED 

Occurs if ★ENABLE is not typed before ★DESTROY. 

DISK WRITE PROTECTED 
Occurs if diskette is write protected. 
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DI R (<dir>) Set the directory 

Changes the current directory to (<dir>). The current directory is 
always set to '$' when you press BREAK . To save files in a different 
directory use this command to change to an alternative directory. 

Example 

★ DIR B 

This sets the current directory to B, giving access to any files in 
directory B. Any files now saved using ★SAVE or BASIC's 
SAVE will be in directory B. 

Description 

Sets the current directory to the assigned argument. 

Remarks 

Directory can be set to any characterexceptthesefourexceptions 

# ★ . : 

This command does not alter the directories written in the 
catalogue. It merely states which directory in the catalogue you have 
access to by default. 

★ DRIVE <dir> Set current drive 

Changes the current drive to <dr>. Any commands which follow 
will work on <dr> until another drive is specified. 

Example 

★ DRIVE 1 

sets the current drive to 1 and 

★ CAT OR ★. 

will produce a catalogue of current drive i.e. DRIVE 1 
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★ CAT 0 


will catalogue drive 0 but the current drive is still drive 1 until you 
change it back to 0 or press BREAK. 

Remarks 

Sets the current drive. 


DUIViP <fsp> 


Produces a hexadecimal listing of a file on the screen. 

Example 

★ DUMP STORE 
Description 

Hexadecimal screen dump. 

Associated commands 

★ LIST 

★ TYPE 

Remarks 

It is useful to use this command in page mode so that the file is 
displayed one page at a time on the screen. 


★ EWABLE 

Some of the filing system commands produce irreversible 
effects. To prevent them from being used accidentally it is necessary 
to type ★ENABLE before they become operational. This prevents 
accidental use. This command must be used with the following:- 

★BACKUP 

★DESTROY 
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Example 

★ B A C 1C U F 

will not work, the message 

Not enabled 

is produced. 

★ENABLE 

★BACKUP 


is ok. 

Remarks 

★ENABLE must be typed immediately before the command to 
be enabled. Any ★ name command typed in between nullifies the 

★ ENABLE. 

★ EXEC <fsp> execute 

This command reads byte by byte all the information in a file as if 
it was being typed on the keyboard, useful for repeatedly typing the 
same sequence of commands. Instead you can build an EXEC file 
consisting of all these commands and type ★EXEC <fsp> each time 
you want this sequence of commands. ★BUILD <fsp> is an 
associated command used to create an EXEC file. 

Example 

★ EXEC STORE 

takes the contents of file STORE and reads it one characterata time as 
if it was being typed at the keyboard. 

Description 

Executes the contents of a named file by reading each byte as if it 
were coming from the keyboard. 

Associated commands 

★BUILD 
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★ FORMAT 


Before any diskettes can be used they must be formatted using 
the FORMAT program stored in ROM. 

Type ★FORMAT or ★ F O . to call the formatter and run it. 

The formatter will first appear as follows: 



TITLE 

BLOCK 


COMMAND 

BLOCK 


PARAMETERS 

BLOCK 


(a) Hit the RETURN KEY in order to start the program or ESC to EXIT 
to BASIC. 

(b) Each disc will be formatted according to the parameters set out in 
the lower 6 sections of the menu. As the "command block" 
(flashing on start up) explains, only certain instructions will be 
executed so it is best to select all instructions by "Toggling" with 
the space bar through the alternatives offered. Pressing the 
escape key will exit the the program and return you to Basic. 
Pressing the space bar will alter the answer to the instruction 
"ARE THE PARAMETERS BELOW CORRECT". If they are, simply 
hit the space bar to obtain the YES answer and then hit RETURN. 
The disc will now be formatted accordingly. 
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If the parameters are not desired, then toggle the space bar to 
obtain the NO answer and hit RETURN, control will now fall through to 
the next block, which will begin to blink accordingly. 


DENSITY 


SINGLE OR DOUBLE 


Toggling the space bar will alternatively select the two options 
SINGLE or DOUBLE density. Single density will give Acorn 
compatability. Double density mode is by definition not Acorn 
compatable as this mode doubles the number of data bits stored on 
the discette. Having made a selection, hit RETURN to move on to the 
next block. 


SINGLE DENSITY = 10 x 256 BYTE SECTORS/TRACK. 
DOUBLE DENSITY = 16 x 256 BYTE SECTORS/TRACK. 


DRIVE NO. 

0 or 1 or 2 or 3 

Toggling the space bar will select the following drives: 0, 1,2 or 
3. Select the drive which contains your unformatted diskette. 

40 on 80 option. 

YES or NO 


Toggling the space bar will allow YES or NO. If you do not have 
80 TRACK drives or do not wish to create a 40 TRACK disk on your80 
TRACK drives, your answer to this option should be NO. If you select 
YES, a check is made to see if you have 80 TRACK drives and the next 
block is automatically answered and you will then skip on to the TITLE 
block. If you select NO, control will drop to the next block. Hit RETURN to 
enter your selection. 


No. of TRACKS 

40 or 80 or 35 

Toggling the space bar will allow 35, 40 or 80 TRACKS. Hit 
RETURN to enter your selection. Control will now fall to the TITLE 
block. 

TITLE 

USER or SYSTEM or MASTER or 
PROJECT or TEXT LIB or BAS LIB 
or CODE LIB. 
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Toggling the space bar will allow pre-selected titles, augmented 
by the number block, coming up next. Alternatively, the title may be 
typed in directly. (Max. 8 char.) Hit RETURN to enter. Control will now 
fall to the last block. 


Number 


XXX from 000 to 999 


The disk number may be entered directly or holding the space 
bar down will cause the number to automatically increment. Both title 
and number will be displayed on the disk, when the catalogue 
command is executed. Hit RETURN to enter, control will now return 
you to the command block. If you make a mistake, toggle the space bar 
to NO and hit the RETURN key in order to follow through the 
parameters blocks once more. If the parameters are OK, then toggle 
YES in the control block and then hit RETURN. You don't get another 
chance, the diskette in the nominated drive will now be formatted 
according to the specifications set out. 


The double density filing system will automatically select the 
density that your diskette has in orderto read orwrite to it. Yoursingle 
density diskettes can be simply copied into double density mode as 
follows. The filing system is a very fast system but may appear slow 
when it is switching densities or tracks, or using Acorn disks. Single 
density disks recopied onto the Microware single density format will 
operate at the new faster speed. 

(a) Format a double density disk in DRIVE 1. 

(b) Insert single density disk in DRIVE 0. 

(c) Use *COPY 0 1 ★ . ★ (Dual Drive units only). 

(For Single Drive use ★COPY 0 0 ★★) 

(d) Copy will now transfer from single density to the new double 
density format. Density switching is automatic. 


Single density disks can be created in a similar way by inserting a 
freshly formatted disk in, say, DRIVE 0, and the double density diskette 
containing the files you wish to copy in DRIVE 1. Now use 

★ COPY 1 0 ★.★. 

All programs copied into single density will run with the Acorn 
DFS provided Acorns specifications are adhered to. The different 
version numbers of DDFS will give the following specifications. 
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.90 ® gives Acorn tape filing system compatability. 
i.e. View, Wordwise, BCPL FORTH, etc. 

• MFM ENCODING i.e. for 100k on Acorn DFS you get 1 64k in 
the new MICROWARE format. 

® 31 filenames. 

.95 • As above plus the following: 

® Diagnostic utility compatability. 

1.0 ® As above with 128 filenames per side in one catalogue. 

1.1 • As above with auto compacting. 

Note: The Company reserve the right to change specs, without notice. 
* See notes in Appendix A. 
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^ HELP <keyword> 


Displays useful information on the screen. In the disk system this 
consists of a list of the filing system commands or the utilities 
depending on the <keyword> used. The two keywords which produce 
a response on the disk filing system are UTILS and MDDFS. 

Example 


★ HELP 

MDDFS .90 

OS 1.2 
> 

★ HELP MDDFS 

MDDFS .90 

ACCESS 

<afsp> (L) 

BACKUP 

<source drv><dest><drv> 

COMPACT 

(<drv>) 

COPY 

<source drv><dest drv><afsp: 

DELETE 

<fsp> 

DESTROY 

ENABLE 

<afsp> 

IWFO 

<afsp> 

RENAME 

<old fsp> <new fsp> 

D 1 R 

<dii> 

DRIVE 

<drv> 

L 1 B 

<dir> 

TITLE 

<disc name> 

VERIFY 

(<drv>) 

WIPE 

<afsp> 

★ HELP U T1 

L S 

MDDFS 

.90 

BUILD 

<fsp> 

DUMP 

<fsp> 

LIST 

FORMAT 

<fsp> 

TYPE 

<fsp> 


★ RUN, ★SPOOL, ★SAVE, ★EXEC and ★LOAD are 

operating system commands. 
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★ SfiMFO <afsp> 


Displays information about a file or group of files. It includes 
details not given by ★ C A T such as the length of the file and its 
location. It is displayed in the following order across the screen. 


Directory 

Filename 

Access 

Load 

Execution 

Length 

Start 




Address 

Address 

in bytes 

sector 


Example 

★ INFO A. STORE 
Displays 

A. STORE L 001900 00801 F 00003B 003 
Description 

Displays detailed file information. 

Associated commands 

★ CAT 
Remarks 

The wildcard facilities # and ★ may be used for information 
about a group of files. 

Messages 

FILE NOT FOUND 

Occurs if correct (AFSP) is not used. 

A LIB :(<drv>). <dir> Selects the library. 

Sets the library to the specified drive and directory. 

Example 

★ LIB : 1 . B 
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sets the library to drive 1 directory B. After this typing 

★ <filename> 

will search directory B on drive 1 for the named file and if it is found the 
file will be loaded and executed just as if you had typed 

★ RUN : 1 . B. <filename> 

Description 

Sets the drive/directory containing the library. 

Associated commands 

★ RUN 
Remarks 

The library can contain files which are utility programs, designed 
to act on other files e.g. Sorts, Edits and Merges. 

^ LIST <fsp> 

Displays a text file on the screen with line numbers. 

Example 

★ LIST TEXT 

displays the contents of the file called TEXT1 on the screen, line by 
line with each line numbered. 

Description 

ASCII list with line numbers. 

Associated commands 

★ TYPE 

★ BUMP 

Remarks 

BASIC is tokenised so listing a BASIC program file will display 
GARBAGE. An A S C 1 II text file of a BASIC program can be obtained 
using the ★SPOOL command. 

Files written with BASIC keyword PRINT # can also be listed 
with this command. 
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★ LOAD <fsp> <address> 


Reads a named file from the disk into memory in the computer 
starting at either a specified start address or the file's own load 
address. 

Example 

★ LOAD STORE 

Reads the file STORE into memory starting at location 1 900 (hex), 
which is the load address of the file when it was saved. 


★ LOAD STORE 7290 

Reads the file STORE into memory starting at location 7290 (hex). 
Other examples are 

★ LOAD "STORE" 

★ LOAD "STORE" 7200 

Description 

Loads a file into memory. 

Associated commands 

★ SAVE 

★ RUN 

Remarks 

The quotation marks are optional; but either a pair, or none 
should be used. 

Messages 

FILE NOT FOUND 

Occurs if named file is not on current directory on current disk. 
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★ OPT 1 (n) 


This command enables or disables a message system which 
displays a file's information (the same as ★ I N FO). Every time a file on 
the disk is accessed the information is displayed, (n) can be anything 
from 1 to 99 to enable the feature, (n) = 0 disables it. 

Example 

★ OPT 1 1 or ★OPT 1, 1 

enables the messages; 

★ OPT 1 0 or ★ O P T 1, 0 

disables the messages. 

Description 

Message system to display file information at every access. 

Associated commands 

★ INFO 

★ OPT 4 (n) 


Changes the auto-start option of the disk in the currently 
selected drive. There are four options to choose from 0, 1,2 or3. Each 
option initiates a different action with SHIFT and BREAKon the 
computer. The computer will either ignore or automatically LOAD, 
RUN or EXEC a file called ! BOOT which must be in the directory 


$ on drive 0. 




Example 

★ OPT 

4 

0 

not used 

★ OPT 

4 

1 

will ★LOAD the file ! B 0 O T 

★ OPT 

4 

2 

will ★RUN the file ! B O 0 T 

★ OPT 

4 

3 

will ★EXEC the file ! B 0 O T 
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Description 

Changes the start-up option of a disk. 

Messages 
BAD OPTION 

Occurs if no space between ★ O P T and numerical parameters 
following, (i.e. ★ O P T 40 should be ★OPT 4 0). 

DISK WRITE-PROTECTED 

Occurs if disk is write protected and ★OPT 4 is invoked. 

With any other option the message 
With any other option than 0. 

FILE NOT FOUND 

is produced if ! BOOT is not found in directory $ on drive 0. 


★ IREMASVIE <o!d fsp> <new fsp> 


Changes the file name and moves it to another directory if 
required. 

Example 

★ RENAME STORE B. FILE 

Assuming that the current directory is $, the file $. STORE becomes 
B. FILE. 

Description 

Renames a file. 

Messages 

FILE NOT FOUND 
Occurs if file does not exist. 
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FILE LOCKED 
Occurs if file is locked. 


DISC WRITE-PROTECTED 
Occurs if disk is write protected. 

FILE EXISTS 

<new fsp> has already been used. 

Important 

^RENAME is not operable between drives. 

★ RUN <fsp> (parameters to utility) 


This command is used to run machine code programs. It loads a 
file into memory and then jumps to the execution address of that file. 

Example 

★ BUft! STORE 

will cause a machine code program in the file called STORE to be 
loaded and executed starting at the execution address of the file. 

Description 

Runs a machine code program. 

Associated commands 

★ SAVE 

★ LOB 

Remarks 

This command will not run a BASIC program. 

Typing ★ <fsp> = ★ R U N <fsp>. 

Typing ★ <filename> results in the file being loaded and 
executed provided it is in the currently selected drive/directory or the 
library. 
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★ SAVE <filename> <start address> 
<finish address>(<execute addr.>) (<reload 
addr.>) 

It is important not to confuse this with the BASIC keyword 
SAVE, they are quite different. This command takes a copy of a 
specified section of the computer's memory and write it on to the disk 
in the current drive/directory. It is put into a file of the given name, 
used mainly in conjunction with machine code programs. 

Example 

★ SAVE 

★ SAVE 

ssss 

FFFF 
EEEE 
RRRR 
LLLL 

Remarks 

RRRR and EEEE may be omitted in which case the reload address 
and the execution address are assumed to be the same as the start 
address. 

Messages 

DISC WRITE-PROTECTED 
Occurs if disc is write protected. 

DIRECTORY FULL 

Occurs if number of file names exceeds upper limit. 

FILE LOCKED 

Occurs if file is locked or already exists. If the file already exists but is 
unlocked it is deleted. 

DISC FULL 

Occurs if, afterfile is deleted due to being unlocked, the system fails to 
carry out a retry at another location. (1.1) 


"STORE” SSSS FFFF EEEE RRRR 
"STORE" SSSS LLLL EEEE 

= Start address of memory to be saved 
= Finish address 
= Execution address (see below) 

= Reload address 
= Length of information 
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^ SPOOL <fsp> 


Prepares a file of the specified name on the disk to receive all the 
information subsequently displayed on the screen. 

Example 

LOAD "STORE" (assumes STORE is BASIC program), 
loads STORE from disk into memory. 

★ SPOOL DATA 

opens a file called DATA on the disk ready to receive information from 
the screen. 


LUST 


causes the basic program to be displayed on the screen and also 
written onto the file called DATA. 

★SPOOL 

turns off the 'spooling' and closes the file called DATA. 

Description 

Spools subsequent output to the screen to a named file opened 
for the purpose. Closes the file when spooling is terminated. 

Associated commands 

★BUILD 

★ EXEC 

★ LIST 

★ TYPE 
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★ TITLE <tiisc name> 


Changes the title of the disk in the current drive to the first twelve 
characters afterthe command. Itfills in with 'nulls' if there are less than 
twelve characters. Any characters are allowed. 

Example 

★ TITLE "DATABASE" 

This sets the title to "DATABASE" with 4 'nulls' added on the end. 
Messages 

DISK WRITE-PROTECTED 
Occurs if disk is write protected. 

See format program. (★FORMAT) 

★ TYPE <fsp> 


Displays a text file on the screen without line numbers. 

Example 

★ TYPE TEXT 
Description 

Screen list of a named file. 

Associated commands 

★ LIST 

★ DUMP 

Important 

BASIC programs are not stored on disk as text files (tokenised) and 
cannot be listed as such. 
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^ WIPE <afsp> 


Removes specified files from the catalogue and rearranges the 
catalogue. Asks for confirmation that each file conforming to the 
specification is to be deleted. 

Example 

★ WORE ★ . S T ★ 

is a request to delete all files on the current drive beginning with the 
letters S T . As each file is found the filename is displayed as follows: 

A. STORE 

At this point you need only type "Y" if you want to delete the file. 
Typing anything else leaves the file intact. 

Description 

Delete with <afsp> and confirmation per file. 

Associated commands 

★DESTROY 

★DELETE 

Remarks 

Locked files are not removed. 

Multifile Operators Allowed. 
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Converting Cassette Programs 

To Disk 


The first thing one usually wants to do after installing a disk 
system, is to transfer all one's programs from cassette onto disk. If the 
programs are written in Basic there is often no problem. Sometimes 
the program doesn't fit because the disk system has reserved some of 
the user RAM for its own use, there are numerous routines to shift the 
program down to &E00 once it has been loaded. 

The three main types of tape to disk transfer are described below. 

1. Single machine-code programs — these won't run because they 
start at &E00 and the disk system reserves that space for its own 
use. 

2. Programs divided into two or more programs — first a Basic part 
which displays the manufacturers advertising page, sometimes 
sets up things such as sound envelopes, and then frRUNsa 
machine code main program. 

3. Basic programs which use high resolution graphics and often 
leave insufficient room when the disk system has taken its RAM. 

TYPE ONE 

Single machine-code programs (e.g. SWOOP). 

To transfer this type, perform the following: 

★ TAPE select the tape filing system 

★ OPT 1, 2 print the file information 

★ LOAD " " 1 900 load the program from tape 

As the tape loads you will see a message of the form: 
FILENAME 05 LLLL FFFFXXXX FFFFEEEE 

Now note down the file length (denoted by LLLL) and the 
execution address (denoted by EEEE) and continue with: 
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★ dusk select the disk filing system 

★ SAVE "FILENAME" 1900 LLLL 7000 

which saves the program on disk. 7000 is location of routine (user 
supplied) to move program to &E00. 

TYPE TWO 

Two-file programs (e.g. MONSTERS, SNAPPER etc.). 

These use a Basic program to display the advertising and to 
★ IR IJ W the main machine-code section. 

The Basic section is odd because, if you LOAD it then SAVE it, the 
SAVEd version will inexplicably be much shorter than the original! 
(and will not run). This is because the graphics data is stored in the 
RAM space immediately following the Basic part, and is thus nota part 
of the Basic program. 

To copy this type do the following: 

★ TAPE 

★ OPT 1,2 

LOAD " " (NB do not use ★LOAD) 

As the tape loads you will see a message of the form: 

FILENAME LLLL FFFFXXXX FFFFEEEE 

Now note down the file length (denoted by LLLL) and the execution 
address (denoted by EEEE) and continue with: 

★ DISC 

★ SAVE "filename" 1900 LLLL 

Note the use of ★ S A V E, this is to ensure that the graphics 
codes are saved as well as the Basic. 

LOAD was used so that the program can be LISTed. LIST the 
program and find the line which ★ R U N s the main machine- 
code section. This line may not be acceptable to the disk system, 
and may require changing for one of the following reasons: 

(a) The program name should contain no more than seven characters. 
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(b) The program name must not be the same as the Basic section's 
program name, otherwise the disc system will be confused. 

(c) There may be no program name at all (e.g. ★ R U ft! this is not 
acceptable to the disk system and a program name must be 
chosen. 

If changes to this line were necessary then re * S A ¥ E it as 
above. 


TYPE THREE 

BASIC programs are transferred to disk in the usual way; 

★ TAPE 
LOAD"" 

★ D II S SC 

★ SAVE "filename" 

Do not attempt to run any programs during transfer, and make 
sure that the filename is no more than 7 characters long. 

TO RUN THE PROGRAMS 

(a) Machine-code programs — these must be shifted down to &E00 
before being run. First set the execution address (denoted by 
EEEE when taking the file off the cassette) and ★RUN the 
program. 

e.g. PRO Cmove (& 1 800): ★ RUN " S W O O P" (Don't omit 
the & before the address (assumes move procedure written 
previously). 

(b) Two-file programs — as above there is a machine code section 
so the execution address must be set up and the 'move' routine 
assembled into RAM. Since the first file is in BASIC is must be 
CHAINed. The line will look like this: 

e.g. PROC move (& 3283): CHAIN "SNAPPER" 

(c) BASIC programs — which won't fit into memory, will almost 
always fit if PAGE is set to &1100. Since the disk system normally 
only uses &E00 to &1100 all that is required is to set PAGE to 
&1100 and CHAIN the program, the line will look like this: 

e.g. PAG E = &1100: CHAI W "SPHINX" 

On some Acornsoft programs the Basic section does nothing 
more than display the advertiser's screen and ★RUN the actual 
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program, in this case the complete Basic section can be omitted if 
required and the game itself treated as a single machine code 
program. 

Sometimes however there is more to it than that, the program 
will often do things like set up sound envelopes, or print instructions. 

NOTE 

Protected software cannot be transferred and advice from the 
userclubs (Beebug orC.U.C.) or manufacturers may be required if such 
a program is encountered. 

TRANSFERRING TAPES TO DISK 

If you wish to transfer a lot of programs, it helps to define the red 
user keys as follows:- 

★ K E V 0 "★TAPE || 

★ KEY 1 " ★ D I S K |j M : ★ D ISI V E <drv> || Rfi " 
<drv> = Drive No. (0-3) 

You can now press fO for tape and load in the program, then press 
fl for disk and S A V E <fsp>. Remember, the name can only be seven 
characters with no spaces allowed in the middle of the filename. 

Using the filing system in 
assembler 

General Principles 

Using the available routines you can perform all necessary 
functions relating to disk files. The relevant routines together with 
their entry points are as follows: 


OSFIND 

&FFCE 

FINDV 

&021C 

Open or close 

a file 

OSARGS 

&FFDA 

ARGSV 

&0214 

Load or save data about a file 

OSFILE 

&FFDD 

FI LEV 

&0212 

Load or save a complete file 

OSBGET 

&FFD7 

BGETV 

&0216 

Read a single 

byte to A 


from the file 
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OSBPUT 

&FFD4 

BPUTV 

&0218 

Write a single byte from A 
to the file 

OSGBPB 

&FFD1 

GBPBV 

&021A 

Load or save a number of 
bytes 

OSWORD 

&FFF1 

WORDV 

&020C 

With A = &7F and a 
parameter block, loads or 
saves a sector 

Supported on .95 . higher. 


OSFIND 

Opens a file for writing or reading and writing. The routine is 
entered at&FFCE and indirects via &21 C. The value in A determines the 
type of operation. 

A = 0 causes a file or files to be closed 

A = &40 causes a file to be open for input (reading) 

A = &80 causes a file to be opened for output (writing) 

A = &C0 causes a file to be opened for input and output(random 

access). 

If A = 80 or &C0 then Y (high byte) and X (low byte) must contain 
the address of a location in memory which contains the file name 
terminated with CARRIAGE RETURN (&0D). On exit Y will 
contain the channel number allocated to the file for all future operations. 
If Y = 0 then the operating system was unable to open the file. 

If A = 0 then a file, or all files, will be closed depending on the 
value of Y. Y = 0 will close all files, otherwise the file whose channel 
number is given in Y will be closed. 

On exit C, N, V and Z are undefined and D =0. The interrupt state 
is preserved, however interrupts may be enabled during the operation. 

OSARGS 

This routine enables a file's attributes to be read from file or 
written to file. The routine is entered at &FFDA and indirects via &214. 
On entry X must point to your locations in zero page and Y contains the 
channel number. 

If Y is non-zero then A will determine the function to be carried 
out on the file whose channel number is in Y. 
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<N CO <3- 


A = 1 write sequential pointer 
A = 0 read sequential pointer 
A = 2 read length 

A = &FF 'ensure' that this file is up to date on the media 

If Y is zero then the contents of A will determine the function to 
be carried out. 

A = 0 will return, in A, the type of file system in use. The value of A 
on exit has the following significance 

0 no file system 

1 1200 baud cassette file system 

2 300 baud cassette file system 

3 ROM pack file system 

4 Disk file system 

5 Econet file system 

6 Teletext/Prestel Telesoftware file system 

A = 1 return address of the rest of the command line in the zero 
page locations 

A = &FF 'ensure' that all open files are up to date on the media 

The file attributes are stored in four bytes. The least significant 8 
bits have the following meanings: 

Bit Meaning 

0 not readable by you 

1 not writable by you 

not executable by you 
not deletable by you 
not readable by others 

5 not writable by others 

6 not executable by others 

7 not deletable by others 

File names are as follows: 

0 nothing found 

1 file found 

2 directory found 
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A brk will occur in the event of an efror and this can be trapped if 
required. 

On exit X and Y are preserved, C, N, V and Z are undefined and 
D = 0. The interrupt state is preserved but interrupts may be enabled 
during the operation. 

Read/write one byte 

OSBGET call address &OFFD7 to get a byte 
OSBPUT call address &0FFD4 to put a byte 

Y contains the channel number on which the file was opened using 
OSFIND. 

X is not used, but preserved. 

A contains the byte to be put or receives the byte which is read. 

The position in the file where the action of the GET or PUT takes 
place is determined by the position of the pointer as set by OSARGS. 


On Exit 

C clear implies a successfully completed transfer. 

C set implies end of file reached before completion of transfer. 

Read/write a group of bytes 

OSGBPB Call address &0FFD1. 

This routine will read or write a byte (or group of bytes) to orfrom 
a specified open file. The option to read or write is determined by the 
value of A. The length of the data and its location are specified in a 
control block in memory. 


On entry X (lo-byte) and Y (hi-byte) point to the instruction block: 

Offset 


0 

1 

5 

9 

D 


Channel 

Pointer to data 

Number of bytes to transfer 

Byte offset in file if used 
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A determines the type of operation: 

A = &01 Put bytes using byte offset 
A = &02 Put bytes ignoring byte offset 
A = &03 Get bytes using byte offset 
A = &04 Get bytes ignoring byte offset 

A = 0 Save a section of memory as a named file. The files 
catalogue information is also written 
A = 1 Write the catalogue information for the named file 
A = 2 Write the load address (only) for the named file 

A = 3 Write the execution address (only) for the named file 

A = 4 Write the attributes (only) for the named file 

A = 5 Read the named files catalogue information. Place the file 

type in A. 

A = 6 Delete the named file 
A = &FF Load the named file 

When loading a file the byte at XY + 6 (the lsb of the execution 
address), determines where the file will be loaded in memory. If it is 
zero then the file will be loaded to the address given in the control 
block. If non-zero then the file will be loaded to the address stored 
with the file when it was created. 

On exit 

X and Y are preserved, C, N, V and Z are undefined and D =0. The 
interrupt state is preserved but interrupts may be enabled during the 
operation. 

OSFILE 

This routine, by itself, allows a whole file to be loaded or saved. 
The routine is entered at &FFDD and indirects via &212. 

On entry 

A indicates the function to be performed. X and Y point to an 18 
byte control block anywhere in memory. X contains the low byte of the 
control block address and Y the high byte. The control block is 
structured as follows from the base address given by X and Y. 

OSFILE control block 

00 Address of file name, which must be terminated LSB 

01 by &0D MSB 
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02 Load address of file LSB 

03 

04 

05 MSB 

06 Execution address of file LSB 

07 

08 

09 MSB 

OA Start address of data or write operations, LSB 

OB or length of file for read operations 
OC 

OD MSB 

OE End address of data, that is byte after LSB 

OF last byte to be written or file attributes 

10 MSB 

11 

The table over page indicates the function performed byosRLEforeach 
value of A. 


On Exit 

C clear implies a successfully complete transfer. 

C set implies end of file reached before completion of transfer. 
The number of bytes and byte offset (if used) are modified to show how 
much data has been transferred (usually as much as was asked for) and 
the new pointer value is the old pointer plus the amount transferred. 

Read/write a sector 

OSWORD with A = &7F 
Call address at &0FFF1. 

A = &F7 indicates that a general read/write operation is required. 
On entry X (lo-byte) and Y (hi-byte) point to the instruction block: 

Offset 

0 

Drive number 
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1-4 

5 

6 
7 

onwards 


Start address in memory of source or 
destination of the data 

Number of parameters 

Command 

Parameters 


Example: 

Number of parameters = 3 

Command = &53 to read or &4B to write 

Parameter 1 = Track number 

Parameter 2 = Sector number 

Parameter 3 = &21 (specifies sector length of 256 bytes 

and 1 to be acted upon) 

Supported on version .95 and higher. 

On Exit 

0 in the last parameter address + 1 indicates a successful 
transfer. A failure is indicated by a disc error number. 


Changing filing systems 

Your computer can have several filing systems available other 
than the disk filing system. The following commands are all used to 
exit from the current filing system into the one named. 


★ TA P E 3 

★ T A P E 1 2 

★ TAPE 

★ WET 

★TELESOFT 

★ ROM 

★ DISK 

★ DISK 


300 baud cassette 

1200 baud cassette 

1200 baud cassette 

Econet filing system 

The prestel and teletext system 

The cartridge rom system 

Enters the filing system from one of 

the others 

Alternative spelling for above 
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Error messages 


&CC Bad filename 

This message appears if you enter a filename which is invalid, 
such as; longer than 7 characters, etc. 

&-D6 File not found 

The Disk filing system could not find the named file in the 
specified drive/directories. 

&C3 File locked 

Access to the named file is locked. This error message is 
displayed when any attempt is made to overwirte or write to a locked 
file. 

&C8 Disc changed 

This error occurs if the computer detects that a disk has been 
changed while files on it are still open. 

&CD Bad drive 

This error means that the : (drv) part of the file specification was 
incorrect, e.g. colon missing or drive number out of range 0 to 3. 

&FE Bad command 

This means that ★ was omitted or that the command name was 
not recognised as a Disk filing system command or utility. 

&CE Bad directory 

Means that the specified directory is not allowed, e.g. More than 
one character. 

&CF Bad attribute 

This error occurs if you use anything other than the letter'L’ with 
the iACCESS command. 

&CB Bad option 

There are currently two 'option' commands ★ O P T 1 and 
★ O P T 4. The error occurs if you type anything else besides 1 and 4 
after ★OPT. 
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&C6 Disk full 

This indicates that there is not enough space on the diskto open 
(OPENOUT #)or save a file of the specified size. 

&BE Catalogue full 

The catalogue has enough space for 31 files. This error is 
produced if you attempt to enter more than 31. 

&C4 File exists 

This occurs if you try to rename a file with an existing filename. 

&C9 Disk read only 

This error occurs if you attempt to write to a disk which has the 
write-protection notch covered. 

&C1 File read only 

This error occurs if you try to write to a file opened for reading 
only, using osfind with A = 40. 

&C7 Disk fault NN at TT SS 

If this error message occurs it means that the computer cannot 
read the disk. It implies that the disk is damaged, faulty, unformatted or 
of the wrong type, like an 80 track disk in a 40 track drive. NN is the 
error number TT is the track number SS is the sector number. 

&C5 Drive fault NN at TT SS 

This error means that the disk drive is probably faulty and needs 
attention. 

&C0 Too many open files 

This error occurs on attempting to open a sixth random access 
file. Five is the maximum allowed at once. 

&CA Bad sum 

Bad checksum. For each random access file opened a control 
block is held in memory. This includes a checksum. A bad sum 
indicates corrupt data in memory and possibly a memory fault. 

&BF Can't extend 

An attempt is made to extend a random access file when there is 
insufficient space immediately after it to do so. 

&BD Not enabled 

An attempt is made to use a use restricted command without 
typing ★ENABLE immediately preceding it. 

&C2 File open 

This error occurs if you attempt to open a file which is already 
open. An intervening close is required between two opens referring to 
the same file. This error is also produced if you try to delete an open file 
with the commands ★DELETE, ★SAVE, ★BUILD etc. 
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CONTROLLER ERRORS (FOLLOWED BY ADDRESS TRACK/SECTOR) 
Result Meaning 

08 During a diskette read operation, a clock bit was 

missing (dropped). The disk operation is terminated 
immediately and an interrupt is generated. 

Most likely cause:- Media failure. 

OA Late DMA. During a diskette read or write operation, 

the BBC processor did not respond within the allotted 
time interval to prevent data from being overwritten or 
lost. This error immediately terminates the operation 
and generates a BREAK error. 

Most likely cause:- Faulty disk controller chip or fault 
on main board NMI lead. 

0C ID CRC error. The CRC word (two bytes) derived from 

the data read inan ID field did not match the CRC word 
written in the ID field with the track was formatted. If 
this error occurs, the associated diskette operation is 
prevented and no data is transferred. 

Most likely cause:- Faulty media. 

0E Data CRC error. During a diskette read operation, the 

CRC word derived from the data field read did not 
match the data field CRC word previously written. If 
this error occurs, the data read from the sector is 
considered invalid and a BREAK "XX" at "YY/ZZ" is 
generated on the BBC. 

Most likely cause:— Media failure. 

10 Drive not ready — the drive addressed was not ready. 

Most likely cause:— Fault on main board. 

12 Write protect. A diskette write operation was specified 

on a write protected diskette. The intended write 
operation is prevented and the data is not written on 
the diskette. 

14 Track 00 not found: during a seek to track 00 

operation, the drive failed to provide a track 00 
indication after being stepped 255 times. 

Most likely cause:— Faulty drive. 
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1 8 Sector not found. Either the sector addressed could 

not be found within 5 revolutions of the diskette or the 
track address specified did not match the track 
address contained in the ID field. 

Most likely cause:- Media failure (possibly 
unformatted). 


APPENDIX A 

MOTES RELATING TO THE FORMAT PROGRAM & DDFS 

® Ensure dip switches are set on keyboard according to table at the 
back. Switch off micro in order that switch settings are read into 
memory, or do hard reset (control/BIK). 

® It is possible to copy 40 track single density to 80 track double 
density on the same drive, provided it has 80 tracks. 

® Early versions of MDDFS do not support a word 7F, machine 
dependant programs that use this function will be supported in 
revision .95 onwards. 

® Diskettes generated on an Acorn system should be * C © IF II E 0 
into the new format, even if only to the new single density in 
order to obtain an increase in speed of operation, additionally 
Microware single density diskettes designed for use on an Acorn 
system should be re ★ C © P1 E D by the Acorn system in orderto 
allow maximum speed of operation. 

@ When changing modes, the modes may seem to take longer to 
find data than previously. This is due to the density/track system 
switching taking place. The system automatically switches from 
single density to double density and then from 40 tracks to 80 
tracks in order to find data. If you were reading 40 track single 
density and change to 80 track double density, then for the first 
data read the maximum amount of switching is required. 
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APPENDIX B 


USING THE UTILITY DISK (SINGLE DENSITY SYSTEMS ONLY) 

An automatic start-up option has been included on the disk and 
this means that you can gain access to the programs via a " M E N U " 
program which will display a list of the programs available on the disk. 

To use this, hold down the SHIFT key and press the BREAK key. 
This is called 'Auto-booting'. Try it now. 

You should find that the red light on the drive comes on and you 
should hear the motor on the drive running. A few seconds later the 
motor should stop and the light go out and an introductory message 
display come up on the screen. 

If this fails to happen and the message "Disk fault" comes up, 
then you need to check that: 

(i) The drive connectors are correctly inserted and in the case of the 

dual drives, that the mains switch on the drive unit is ON. 

(ii) the disk has been inserted into the correct drive and that it is the 

RIGHT WAY ROUND. Check earlier for mention of the way to 

insert the disk. 

After about 15 seconds, the display should be replaced with a 
"MENU " listing all the programs available. 

The first thing you need to do is to make back-up copy of the 
Utility disk. This is advisable in case anything goes wrong when you 
are using the drive and data on the diskgets corrupted, and alsoforany 
important programs you may have. 

Assuming that you have bought a batch of blank disks, you will 
need to 'format' them ready to accept data in a form understandable to 
the computer. In general, like cassette tapes, disks produced on one 
computer may not necessarily work on another manufacturer's one. 

If no errors have occurred you can format anotherdisk by replying 
' Y ' to the message: 

Format another disk (Y/N) ? 
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The program will assume you want the same drive number and 
number of tracks. 

To change to a different drive number, e.g. to format the other 
side of a disk in a double sided drive, or to change the number of tracks 
required, simply press 'ESCAPE' and type 'BUM' and the 
Formatter will re-start. 

This concludes the explanation on the formatter and it is a good 
idea to format all your blank disks at the same time. 

Now you have formatted some disks you can make a back-up 
copy of the Utility disk. To do this, there are two commands: 

ft E HI A B L E 

★BACKUP <source drive> destination drive> 

The command ★ E M A B L E must be used in this and forcertain 
other disk commands which have drastic effects on disk files. 

In the * BACKUP command the <source drive> is the drive 
which contains the disk you wish to copy from and the destination 
drive>, the drive containing a blank (but formatted) disk ready to be 
copied to. 

If you only have a single drive unit you need to specify source and 
destination drives as being number 0 (or 2 if you have a double sided 
drive). When you enterthe command,the computerwill prompt you to 
insert the source disk and then ask you to remove this disk and insert 
the blank (destination) disk. This will happen several times as the 
computer only transfers one file at a time. Be careful that you do not get 
the disks mixed during these transfers. To help you, place a small 
adhesive label (normally supplied with blank disks) over the "Write 
Protection" notch (mentioned earlier on) cut in the side of the Utility 
disk if this is not already fitted. This will prevent any information being 
overwritten on Utility disk. 

An error message will be produced if an attempt is made to write 
to protected disk: 

Disk write protected 
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For single drive users enter the commands: 


★ENABLE 

★ BACKUP 0 0 

and then follow the instructions given by the computer. 

For those with dual drives, you can insert the Utility disk in Drive 
0 (left-hand drive) and the blank disk in Drive 1 (right-hand). In this 
way, unlike the single drive unit, the computer will transfer all the files 
from one drive to the other without any intervention. 

Use the commands: 

★ENABLE 

★ BACKUP 0 1 

You will be able to see the two drives being activated alternately 
(watch the drive LED lamps where fitted). 

You now have a copy of the Utility disk which you can use when 
needed whilst keeping the original as a master. 

Another program on the Utility disk is VERIFY which is used for 
checking the entire disk for any errors (or 'corruptions') which may 
have occurred. This works in a similar manner to the Formatter by 
asking you for the Drive number containing the disk to be checked. 

You can assess the program from your Utility disk by calling (or 
'booting') the Menu program. This is done by holding down the SHIFT 
key and pressing the BREAK key the same way as before. Pressing the 
appropriate letter when the Menu is listed will load and run the 
program. Alternatively you can enter: 

C H A I N " A. V E R I F Y " 

The program should load and you should get the message: 

Drive No. ? 

Leave the Utility disk in the drive and for this exercise verify the 
Utility disk you have just made. 
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Type 0 if the disk is in Drive 0. 

The following message should appear: 

Ready to verify drive (Y/N)? 

Type 'Y' and the program will start. 

There is no need to specify the number of tracks as the program 
reads the disk size from the Catalogue sectors recorded on track 0. 

As with the formatter a series of numbers corresponding to each 
track as it is checked will appear. 

When complete, the results of the verify will be displayed: 

40 Track Disk 

Drive 0 verify complete 

0 Verify errors 

This is what you should get if successful (this is assuming Drive 0 
selected and a 40 track disk used). 

Any errors found, again, will be shown by a ?' following the track 
number. If a disk does contain errors then all the files on it should be 
transferred to another disk if possible and the problem disk reformatted. 

The message '40 Track Disk' tells you the number of tracks the 
disk has been formatted for. if the program has not read a valid disk 
size i.e. 35, 40 or 80 tracks then you would get the message: 

Disk not formatted 

This verify program can therefore prove useful forchecking disks 
that apparently fail to work by detecting corruption of the data on them 
or if you have forgotten to format them before use. 

Data is recorded as a series of'tracks' and there can be either40 
or 80. Each track is sub-divided into ten 256 byte blocks called 
'sectors'. 40 tracks will hold up to 100k bytes of data and 80 tracks will 
hold up to 200k bytes. These tracks and sectors are absent on blank 


64 



disks and therefore need to be recorded before you can save any 
programs. 

There is a program on the Utility disk called "F O R M AT" and 
by loading and running this program you can pre-record the required 
tracks and sectors. The program is also used to set-up the Catalogue 
required for holding the information about files saved on the disk. 

To run the program is simply a matter of typing the appropriate 
letter next to the program name as it appears in the menu listing. The 
Menu program will automatically load and run the program. Try it now. 

You should find that the disk drive will start-up again and the 
formatting program will be loaded and run. 

You could also access the formatting program direct by using the 
CHAIM command as used with cassette files, i.e.:- 


CHAIN " A. FORMAT " 


The program will then ask you a series of questions about the 
disk you wish to format:- 

Drive No. ? 

Type 0 to indicate that you want to use drive 0. 

The message " REMOVE FORMATDISK" will appear to 
remind you to remove the Utility disk otherwise all the information on 
it will be erased. 

The message: 

Insert blank disk into drive 0 

will appear to prompt you to put your blank disk into the drive. 
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The next question asked will be: 


No. of tracks required (80, 40, 35) ? 

Type the number 80, 40, or 35 depending on what type of drive 
you are using. 80 track drives may however be used for formatting 40 
and 80 track disks if you have a "Switch Option" fitted. Make sure this 
switch has been set for the correct number of tracks. This is important 
particularly when formatting 40 track disks as it is possible to format 
for 40 tracks with the drive switched for 80 tracks without any error 
being detected. You would then find that the disk would produce error 
messages when used on a 40 track drive. However, trying to formatfor 
80 tracks using a 40 track drive would produce errors messages by the 
formatter program. 

You will then be asked: 

Ready to format drive (Y/N) ? 

Type Y and the program will start with the acknowledgement: 

Formatting Drive 0 — Please wait 

As the program proceeds, a series of numbers (hex) will appear. 
These represent the track numbers as they are being formatted. 

On completion you should see: 

Drive 0 formatting complete 
0 Format errors 
0 Verify errors 

Format another disk (Y/N) ? 

The 'format errors' count gives the number of errors encountered 
when attempting to write to the tracks. The 'verify errors' count 
indicates any errors encountered when reading back the information 
recorded when the tracks were formatted. These errors can be seen as 
' ? ' appearing next to the track numbers: 

e.g. 00 ? 01 . . — format error on track 0 

00 ?01 . . — verify error on track 0 

00??01 . . — format and verify errors 
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If errors have occurred, you will be asked: 

Another try (Y/N)? 

Type Y and the formatting process will be repeated. The program 
will assume the same Drive number and the same number of 
tracks. If after three attempts you are still getting errors then the 
disk is probably faulty. If you are getting ' ? ? ' after each track 
number, check that the drive unit is correctly connected. 
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APPENDIX C 


Keyboard Link Settings 


(link 1 TO LEFT) 


LINKS 


1 

2 


ACTION 

u 

U 

DRIVE 0 & 2 & 1 & 3 ARE 40 TRACK DRIVES 

u 

M 

DRIVE 0 & 2 ARE 40 TRACK & DRIVE 1 & 3 ARE 



80* TRACK. 

M 

U 

DRIVE0&2ARE80* TRACK & DRIVE 1 8-3 ARE 



40 TRACK. 

M 

M 

DRIVE 0 & 2 & 1 & 3 ARE 80 TRACK* 

*Not to be used on 40 track drives. 

LINKS 


ACTION 

3 

4 

DISK DRIVE SELECTION 



TRACK TO TRACK TIME 

U 

U 

30 MSEC 

U 

M 

20 MSEC 

M 

U 

12 MSEC 

M 

M 

6 MSEC 

5 


AUTOBOOT SELECTION 

U 


BY PRESSING SHIFT/BRK. 

M 


BY PRESSING BRK. ONLY 

6 7 8 

SCREEN MODE ON BRK. 

U 

U 

U 

MODE 7 

U 

U 

M 

MODE 6 

U 

M 

U 

MODE 5 

U 

M 

M 

MODE 4 

M 

U 

U 

MODE 3 

M 

U 

M 

MODE 2 

M 

M 

U 

MODE 1 

M 

M 

M 

MODE 0 


U = UNMADE M = MADE 
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APPENDIX D 


Filing system 
command summary 

Command (Minimum abbreviation, full-stop required) 


★ ACCESS (★ A . ) 

★ BACKUP (★ B A C .) 

★ BUILD (★BU.) 

★ CAT (★ .) 

★ COMPACT (★COM.) 

★ COPY (★COP.) 

★ DELETE (★ DE.) 
*DESTROY(*DES.) 

★ DIR (★ D I . ) 

★ DRIVE (★DR.) 

★ DUMP (★ D U . ) 

★ ENABLE (★EN.) 

★ EXEC (★ E . ) 

★ FORMAT (★FO.) 

★ HELP (★ H . ) 

★ INFO (★ I . ) 


Purpose 

Locks or unlocks a file. 

Copies all information from one 
disk to another. 

Causes all subsequent keyboard 
entries to be stored in the named file. 

Displays a disk catalogue. 

Collects all files on a disk together 
into one continuous sequence 
leaving a single block of free space. 

Copies all specified files from one 
disk to another. 

Removes a single named file from 
the disk. 

Removes specified files from a 
disk in a single action. 

Changes the current set directory. 
Changes the current set drive. 

Produces a hexadecimal listing of a 
file. 

Allows the use of ★ B AC K U Pand 

★DESTROY 

Reads a disk file byte by byte as if 
the bytes were being typed on the 
keyboard. 

Enter format utility. 

Displays the file system commands 
with syntax guidelines. 

Displays information about specified 
files. 
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★ LIB 

(★LIB) 

★ LIST 

(★LIST) 

★ LOAD 

★ OP T 1 

(★L.) 

(★0.1) 

★ O P T 4 

(★0.4) 

★ RENAME 

★ RUN 

★ SAVE 

(★RE.) 

(★ R . ) 
(★S.) 

★ SPOOL 

(★ S P . ) 

★ TITLE 

★ TYPE 

(★ T 1 . ) 

(★ T Y . ) 

★ VERIFY 

(★V.) 

★ WIPE 

(★ W.) 


Selects the drive/directoryforthe 
libra ry. 

Displays a text file on the screen with 
line numbers. 

Reads a file from disk to memory. 

Switches screen messages which 
accompany disk accesses on or off. 

Specifies the auto-start option of 
a disk relating to a file named 

:0.$.!BOOT. 

Changes a filename. 

Runs a machine code program. 

Saves a specific part of memory to 
the disk. 

Transfers all text subsequently 
displayed on the screen into a 
specified file. 

Changes the title of a disk. 

Displays a text file on screen with 
line numbers. 

Checks legibility of every sector 
on a disk. 

Removes specified files from the 
disk after confirmation for each 
file meeting the given specification. 
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RECOMMENDED READING 


(1) The BBC Microcomputer Disk Companion 
by Tony Latham 

(2) The Advanced User Guide 
Carl Price 

(3) The BBC Micro — An Expert Guide 
Mike James 


★ We wish to thank Acorn Computers Ltd. for the use of information 
from the user guide and disk drive hand book. 
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Index 


★ ACCESS.20 

★ BACKUP.21 

! B O O T.22 

★ BUILD.22 

★ CAT.23 

★ COMPACT .24 

★ COPY .26 

★ DIR.29 

★ DRIVE .29 

★ DELETE .27 

★ DESTROY .28 

★ DUMP.30 

★ ENABLE.30 


★ ERROR CODES.57 

★ FORMAT.32 & 60 

★ HELP.36 

★ INFO.37 

★ KEY.50 

★ LIB.37 

★ LIST.38 

★ RENAME.41 

★ OPT.40 

★ TAPE.47 

★ TITLE.45 

★ TYPE.45 

★ WIPE.46 
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